home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / hckfax10.lzh / READ_ME.TXT < prev    next >
Encoding:
Text File  |  1993-05-02  |  9.3 KB  |  243 lines
  1.  
  2.  
  3. Kurzanleitung zu HackFax
  4. ========================
  5.  
  6.  
  7. Was ist HackFax?
  8. ----------------
  9.  
  10. HackFax ist ein Programmpaket für die Atari/TOS Computer und ein 
  11. ZyXEL Fax-Modem. Mit Hilfe dieses Programmpaketes ist es möglich,
  12. Fax Seiten zu Senden, zu Pollen, zu Empfangen, Anzuschauen, zu
  13. Drucken und Weiterzuverarbeiten.
  14.  
  15. HackFax ist Freeware. D.h. man darf das Programmpaket unentgeltich
  16. benützen und beliebig oft kopieren und weitergeben. Die Weitergabe 
  17. ist nur gestattet, wenn dafür keine Gebühren oder sonstige Zahlungen
  18. verlangt werden. Eine Verbreitung über Mailboxen ist erwünscht.
  19.  
  20. HackFax wurde von Helmut E. Neumann und Markus Bubendorf entwickelt.
  21. Bei Problemen, Fragen, Fehlermeldungen und Verbesserungsvorschläge
  22. wende man sich an Markus Bubendorf. Fehlermeldungen bitte immer mit
  23. einer genauen Beschreibung des Fehlers und der Umgebung (Version von 
  24. HackFax, TOS-Version, ROM-Version des Modems, AUTO-Programme, 
  25. Accesories, Konfigurationsdateien, Kommandozeile, Startprogramm etc.)
  26.  
  27.  
  28.  
  29. Was gehört zu HackFax?
  30. ----------------------
  31.  
  32. Dieses Paket enthält nur die ausführbaren Programme mit den dazu
  33. gehörenden Dateien. Auf Wunsch kann jeder Interessierte den Sourcecode
  34. bei Markus beziehen. Dazu muss man lediglich eine formatierte Diskette
  35. und das Geld für das Rückporto (Bitte Schweizer Franken!) an Ihn schicken.
  36.  
  37. Dieses Paket enthält HackFax in der Version 0.70. Dazu gehören die
  38. folgenden Dateien. Sollte eine odere mehrere der Dateien fehlen, so
  39. melde Dich bei Markus mit der Angabe, wo Du das Paket bezogen hast.
  40.  
  41. Datei                 Bemerkung
  42. -------------------------------------------------------------------
  43. FAXVIEW.PRG           Anzeige-, Druck- und Konvertierprogramm
  44. FAXVIEW.RSC           Resource-File dazu
  45. FAXVIEW.SYS           Gespeichertes Setup von FaxView
  46. RCVFAX.TTP            Programm, um Fax-Seiten zu Empfangen
  47. SENDFAX.TTP           Programm, um Fax-Seiten zu Senden
  48. ASC2G3.TTP            Konverter ASCII-->Fax-Seiten
  49. QFAX2G3.TTP           Konverter Fax-Seiten vom QFax-Format ins HackFax Format
  50. HACKFAX.CFG           Konfigurationsdatei für die Programme
  51. FAX1628.FON           Zeichensatz (16*28) für ASC2G3
  52. FAX0816.FON           Zeichensatz ( 8*16) für ASC2G3
  53. FAX0814.FON
  54. FAX0812.FON
  55. FAX0716.FON
  56. READ_ME.TXT           Dieser Text hier
  57. BEISPIEL.TXT          Beispieltext für ASC2G3
  58. UPDATE.TXT            Text mit Neuerungen gegenüber älteren Versionen
  59.  
  60.  
  61.  
  62. Wie bedient man HackFax?
  63. ------------------------
  64.  
  65.  
  66. Als allererstes ist die Datei HACKFAX.CFG an die eigenen Bedürfnisse
  67. und Gegebenheiten anzupassen. HACKFAX.CFG ist eine einfache Textdatei,
  68. die mit jedem Editor editiert werden kann. Der Aufbau der Datei ist
  69. in ihr selbst erklärt.
  70.  
  71.  
  72. ASC2G3.TTP
  73. ----------
  74.  
  75. Aufruf: asc2g3 textfile
  76.  
  77. ASC2G3 konvertiert ein ASCII-Textfile in ein Fax-File. Dieses Fax-File
  78. kann anschliessend mit SENDFAX.TTP verschickt werden. Die Konvertierung
  79. geschieht gemäss den Angaben in HACKFAX.CFG. Der Filename des Fax-Files
  80. besteht aus dem Grundnamen des Textfiles plus der Endung FAX.
  81.  
  82. Innerhalb des Textfiles sind gewisse Steuermöglichkeiten mit Hilfe von
  83. Kommandos möglich. Alle Kommandos bestehen aus dem Zeichen '~' dem
  84. direkt der Kommandobuchstabe folgen muss. Hinter dem Kommandobuchstaben
  85. folgen direkt die Parameter (falls vorhanden).
  86. Es wird unterschieden zwischen Zeilenkommandos und Buchstabenkommandos.
  87. Die Zeilenkommandos müssen direkt am Zeilenanfang stehen und wirken
  88. sich auf die nachfolgenden Zeilen aus. Text, der hinter einem Zeilen-
  89. kommando steht, wird ignoriert.
  90. Die Buchstabenkommandos dürfen irgendwo innerhalb einer Textzeile 
  91. stehen und ändern das Aussehen der einzelnen Buchstaben.
  92.  
  93. Folgende Zeilenkommandos sind möglich:
  94.  
  95. ~Ln m : Zeilenabstand neu setzen. n gibt die Anzahl der Zeilen vor den
  96.         Buchstaben an. m gitb die Anzahl der Zeilen nach den Buchstaben an.
  97. ~P    : Neue Seite beginnen
  98. ~Ifile: Textfile 'file' an der aktuellen Position einsetzen. Nachdem file
  99.         abgearbeitet wurde, wird mit der aktuellen Textdatei weitergefahren.
  100.         Es können max. 8 Texte ineinander verschachtelt werden.
  101. ~Cfile: Die Bearbeitung des aktuellen Textfiles wird beendet und es wird
  102.         mit file weitergemacht.
  103. ~Ofile line from: Graphikdatei 'file' an der momentanten Position einfügen.
  104.         Die Graphik wird über den Text (wie Folien) gelegt. line gibt die
  105.         max. Anzahl der Zeilen an. from gibt den Offset in Bytes an, den
  106.         die Graphik vom linken Rand haben soll.
  107.         Unterstüzte Graphikformate: DOODLE 400*640
  108. ~Sfile line from: Wie ~O; die Graphik wird aber nicht über den Text gelegt,
  109.         sondern zwischen den Text eingefügt!
  110. ~Xn   : Zeichenabstand auf n Pixel ändern
  111. ~;    : Kommentarzeile
  112. ~:    : Kommentarzeile, die aber auf den Bildschirm und in das LogFile
  113.         ausgegeben wird.
  114.  
  115. Buchstabenkommandos:
  116.  
  117. ~B    : Auf Fettschrift umschalten (Noch nicht implementiert)
  118. ~N    : Normalschrift
  119. ~I    : Auf Schrägschrift umschalten (Noch nicht implementiert)
  120. ~U    : Buchstaben unterstreichen (Noch nicht implementiert)
  121. ~Cn   : Zeichenabstand auf n Pixel ändern
  122.  
  123.  
  124. QFAX2G3.TTP
  125. -----------
  126.  
  127. Aufruf: qfax2g3 qfaxfile [[qfaxfile]qfaxfile...] hackfaxfile
  128.  
  129. Die angegebenen QFax Dateien werden zu einer Datei zusammengefasst und
  130. in der Datei hackfaxfile im HackFax Format gespeichert. Die Endung
  131. dieser Datei lautet immer auf .FAX. Sollte die Datei hackfaxfile 
  132. bereits existiert, so werden die QFax-Files an diese Datei angehängt.
  133. Die Konvertierung ist nur dann möglich, wenn die Auflösung und die
  134. Kodierungsart in allen Dateien gleich ist.
  135.  
  136. Rückgabewerte: 0: Konvertierung verlief ohne Fehler
  137.                1: Fehler beim Konvertieren
  138.  
  139.  
  140. RCVFAX.TTP
  141. ----------
  142.  
  143. Aufruf: rcvfax [MAILER|IMMED|WAIT|WAITONE]
  144.  
  145.  
  146. Es werden ein oder mehrere Faxe empfangen. Wird keine Betriebsart in der
  147. Kommandozeile angegeben, so wird die Standardbetriebsart gemäss der
  148. Konfigurationsdatei HACKFAX.CFG genommen. Ist beim Start von RCVFAX.TTP
  149. die Leitung CD (Carrier Detect) aktiv, so wird unabhängig von den Angaben
  150. immer die Betriebsart MAILER eingenommen. Die Betriebsart hat folgende
  151. Auswirkungen auf das Verhalten des Programmes:
  152.  
  153. MAILER : Das Modem befindet sich bereits im Fax-Connect Zustand. Es kann
  154.          sofort mit dem Empfangen der Faxseiten begonnen werden. Weder
  155.          der INIT noch der RCVINIT String wird ans Modem geschickt. Die
  156.          serielle Schnittstelle und das Modem muss vom aufrufenden Programm
  157.          korrekt initialisiert worden sein. Die Parameter des Fax-Connects
  158.          müssen noch im Puffer der seriellen Schnittstelle sein. Nach
  159.          Empfang der Fax-Seiten wird das Programm beendet.
  160. IMMED  : Das Modem und die serielle Schnittstelle wird initalisiert.
  161.          Gleich anschliessend wird versucht, ein Connect zu erreichen. Bei
  162.          einem Fax-Connect werden die Fax-Seiten empfangen. Bei einem
  163.          sonstigen Connect wird das MAILER-Programm aus HACKFAX.CFG
  164.          gestartet. Kommt kein Connect zustande, so wird das Programm
  165.          beendet. Ebenso wird das Programm beendet, wenn die Fax-Seiten
  166.          empfangen wurden und wenn das MAILER-PROGRAMM beendet wurde.
  167. WAIT   : Es wird auf einen Anruf gewartet und nach der unter RING
  168.          eingestellten Anzahl von RINGs entgegengenommen. Je nach Connect
  169.          wird das MAILER-Programm gestartet oder die Fax-Seiten empfangen.
  170.          Anschliessend geht das Programm wieder in die Warteschleife.
  171. WAITONE: In dieser Betriebsart wartet RCVFAX.TTP ebenfalls auf einen Anruf.
  172.          Nachdem dieser beantwortet wurde, wird das Programm allerdings
  173.          beendet.
  174.  
  175.  
  176.  
  177. SENDFAX.TTP
  178. -----------
  179.  
  180. Aufruf: sendfax nummer faxfile
  181.  
  182.  
  183. Die Datei faxfile wird an das Fax-Gerät unter der Nummer 'nummer'
  184. geschickt. Unabhängig davon, ob die Datei fehlerfrei verschickt werden
  185. konnte oder nicht, wird das Programm nach einem Anruf beendet.
  186. Wenn innerhalb der Nummer Leerzeichen verwendet werden (z.B. 482 02 20),
  187. so muss die ganze Nummer in Anführungszeichen " gesetzt werden.
  188.  
  189.  
  190.  
  191. FAXVIEW.PRG
  192. -----------
  193.  
  194. Mit FaxView kann man erstellt Fax-Dateien vor dem Versenden kontrollieren
  195. und empfangene Fax-Seiten anschauen. Das Programm kann zusätzlich zu den
  196. HackFax Dateien auch die Fax-Dateien von ZFAX (MS-DOS Programm) und QFax
  197. verarbeiten.
  198. Das Programm ist in GEM programmiert und sollte selbsterklärend sein.
  199.  
  200.  
  201.  
  202. Was, wenn etwas nicht wie gewünscht läuft?
  203. ==========================================
  204.  
  205. Kein Programm ist fehlerfrei. Wer einen Fehler gefunden hat, soll mir 
  206. diesen bitte melden, damit ich ihn beheben kann. Bei Fehlermeldungen
  207. bitte IMMER die folgenden Informationen mitliefern:
  208. - Konfigurationsdatei (HACKFAX.CFG)
  209. - Computer-Modell, TOS Version, AUTO-Programme, Accesories
  210. - ROM-Version des ZyXEL (ATI, ATI1)
  211. - Programmversion (entspr. Programm mit '-v' starten)
  212. Der Fehler muss von mir reproduzierbar sein. Dazu benötige ich die
  213. verwendeten Dateien. Ausserdem ist das Programm danach zu untersuchen,
  214. ob es ev. nur zusammen mit einem AUTO-Programm bzw. einem Accesory
  215. Probleme macht.
  216.  
  217.  
  218.  
  219. Adressen (Fehlermeldungen bitte nur an Markus):
  220.  
  221.  
  222. Autor des Originalpaketes:
  223.  
  224. Helmut E. Neumann
  225. Im Appensee 4
  226. W6100 Darmstadt 23
  227. BR Deutschland
  228.  
  229.  
  230. Weiterentwicklungen:
  231.  
  232. Markus Bubendorf
  233. Kirchgasse 3
  234. 4124 Schönenbuch
  235. Schweiz
  236. Telephon: +41 (0)61 482 02 20
  237. Bitte keine Faxe schicken, da der Computer i.d.R. ausgeschaltet ist.
  238.  
  239. E-Mail: Markus Bubendorf on 2:301/216.3 @ FidoNet
  240.  
  241.  
  242.  
  243.